home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 4 / Apprentice-Release4.iso / Languages / RLaB 1.18c / README.mac < prev    next >
Text File  |  1995-02-25  |  11KB  |  154 lines
  1.                   |                             |-- rlib
  2.          --------- App -----|                             |
  3.          |                  |                             |-- examples
  4.    HD ---|                  ----- RLaB (you are here) ----|
  5.          |                                                |-- help
  6.          -------- Kevin                                   |
  7.                                                           |-- toolbox
  8.          
  9.    When you launch RLaB, you are in RLaB directory.  If you wish to 
  10.    change directory to "examples", you can use either
  11.    
  12.    >cd(":examples");  // relative method
  13.    
  14.    or
  15.    
  16.    >cd("HD:App:RLaB:examples");  // absolute method
  17.    
  18.    The colon ":" means present directory, it is similar to "." on the Unix
  19.    but not exactly the same.  You MUST supply a ":" as first char if partial 
  20.    (relative) pathname is used.  If the first character of a pathname is not 
  21.    a ":", it is a full (absolute) pathname.  Two colons "::" means parent 
  22.    directory (folder).  Three colons ":::" means grandparent directory.
  23.    The ":" character also acts as directory delimiter, like "/" on the unix 
  24.    and "\" on the MS-DOS.
  25.    
  26.    For example, if your work directory is in Kevin and you are in 
  27.    RLaB now,  you can use either
  28.    
  29.    >cd(":::Kevin");   // relative method
  30.    
  31.    or
  32.    
  33.    >cd("HD:Kevin");   // absolute method
  34.    
  35.    to change directory to Kevin.
  36.  
  37. 4. RLaB comes with a built-in plotting library PLPLOT.  PLPLOT is a powerful 
  38.    tool for XY and XYZ graphics.  It can generate (via plprint) Postscript, 
  39.    color Postscript, HP LJ, and lots of other formats for post processing. 
  40.  
  41.    I've implemented a minimum Mac interface for PLPLOT4.99i.  Multi-window is 
  42.    allowed but the redrawing is slow; well, that depends on what machine you 
  43.    got.  The number of windows is limited to 10.  
  44.    
  45.    The mac-plplot interface is based on ColorQuickDraw routines.  Sixteen 
  46.    colors are directly available in PLPLOT. These colors are pre-assigned 
  47.    as the following numbers:
  48.    
  49.       1       2         3        4        5         6         7       8
  50.      black   red    yellow      green  aquamarine  pink     wheat   gray
  51.    
  52.       9      10        11       12       13        14        15      16
  53.      brown   blue   blueviolet  cyan   turquoise   magenta  salmon  white 
  54.       
  55.    You can select color by _plcol() function.  More colors are available by
  56.    using RGB combinations (see PLPLOT manual). There are three things remained  
  57.    to be done -- add scroll bar to the MacRLaB window, add copy/paste ability 
  58.    in the graphics windows, and add PICT image to the generated EPSF files.
  59.    
  60.    You can include the PLPLOT generated Postscript output (EPSF) in your 
  61.    document (Word, MacDraw, Canvas, TeX, ...) but you can only see a 
  62.    big crossed box (the bounding box) on the screen due to the lack of the 
  63.    PICT image. You can perform scaling, rotating, dragging,... on the box 
  64.    except there is no picture inside.  Don't worry, the picture will appear 
  65.    in the printed copy.
  66.    
  67.    If you need superscript, subscript, over/under line char, and Greek letters 
  68.    in annotation of axis, title, etc., then you need to get a copy of PLPLOT 
  69.    manual.  See README.PLPLOT for detail.  
  70.    
  71.    There is a plotting example in ":examples:plot_test.r", try
  72.    
  73.    >rfile plot_test
  74.  
  75.    You can click on those background windows to see them again. The graphics 
  76.    windows are numbered as plplot 0, plplot 1, plplot 2, ..., and so on.  You 
  77.    can also resize or drag them.  Resizing on the screen will not affect 
  78.    the quality of later plprint() output. 
  79.    
  80.    For each graph window, there is a temporary file (SCRATCH????) 
  81.    associated with it.  It contains your plotting commands which can be used
  82.    later to produce a Postscript or other types of graphics file (via
  83.    plprint).  It is also used by my Mac interface in redrawing.  Don't dump
  84.    them into trash can during the execution of MacRLaB.   They will be 
  85.    automatically eliminated after the execution.   Also, don't use pend() 
  86.    to close graphics windows unless you don't want to plot anymore. Use 
  87.    pclose() instead.  plplot has a bug that it does not close the plotting 
  88.    command file even you close the graphics window by pend() or pclose().  
  89.    So if you plot after pend(), the old picture together with the new picture
  90.    will appear on the graphics window.
  91.    
  92.    If you plot several pages of PS graph into a file, you have to change 
  93.    the file type to 'TEXT' (all capital) by drag and drop the file onto
  94.    ctc 1.5.  After the file type has been changed, you can print it out 
  95.    by Drop•PS or ShowPages.  Why?  Because plplot creates the PS output file
  96.    in binary mode, but Drop•PS and ShowPages accept only TEXT file.
  97.       
  98.  
  99. 5. The full history command editing capacity is built-in.  To recall 
  100.    previous commands, just press up and down arrow keys.  
  101.    The 'control' key described in the RLaB Primer can be replaced by the 
  102.    'command' key on the Mac keyboard.  Delete-cursor-character (del) is also 
  103.    supported.  The full description of command line editing is in the file
  104.    ":help:COMMAND_EDIT", or type "help COMMAND_EDIT" in RLaB.
  105.  
  106.    
  107. 6. Your machine must have a 68020 or better cpu to run MacRLaB.  You also 
  108.    need System 7 to run it.  If your machine does not have an fpu (68881 or 
  109.    better) then you should run MacRLaB-nofpu instead of MacRLaB.
  110.    
  111.    Try
  112.    
  113.    >load("test")
  114.  
  115.    on your machine to see if your machine can pass all tests.
  116.          
  117. 7. The total size of arrays is only limited by the available memory of your 
  118.    machine.  If RLaB runs out of memory, it will display
  119.        
  120.         RLaB: out of memory. 
  121.         
  122.    on the screen.  You can either increase RLaB memory using 'Get Info' of 
  123.    System 7 Finder or, if your physical RAM is limited, turn on the virtual
  124.    memory and set the memory size large enough for your application.
  125.  
  126. 8. To interrupt RLaB during execution, type command-. (i.e. press command 
  127.    key + period key), it will return to the interactive mode in the next i/o.  
  128.    To abort RLaB and kick it out, you can use File-Quit (command-Q) on Menu bar. 
  129.    You can also do so by type in command-d at the beginning of a command 
  130.    line, or type "quit" directly.
  131.    If RLaB hangs, press command-option-esc to abort it.
  132.  
  133. 9. The source code of mac version is merged in the rlab source code 
  134.    distribution (see :misc:ftp-sites).  Those statements within 
  135.                #ifdef THINK_C  ... #endif 
  136.    are my modifications for THINK C 7.03 compiler on the Mac.  I've modified the 
  137.    console user interface.  Three difference files diff1, diff2, and diff3 
  138.    tell you those modifications (they are in :misc:MAC).  You also need f2c 
  139.    and POSIX libraries.  They are available in info-mac archives.
  140.    
  141. 10. If you wish to join the RLaB community, send an email to Ian 
  142.     (ians@eskimo.com) and ask him to add your name in the mailing list.  
  143.     You can reach the RLaB community by sending email to rlab-list@eskimo.com.
  144.    
  145. 11. We need more tools.  Please send your useful rfiles to Ian.  Thanks.
  146.  
  147. 12. THIS IS FREE SOFTWARE. THERE IS NO WARRANTY FOR THE PROGRAM.  USE IT AT 
  148.     YOUR OWN RISK.  
  149.  
  150. Have fun!
  151.  
  152. Tzong-Shuoh Yang   
  153. (tsyang@ce.berkeley.edu) 
  154.